Added or corrected Commentary headers
authorEric S. Raymond <esr@snark.thyrsus.com>
Mon, 22 Mar 1993 16:53:22 +0000 (16:53 +0000)
committerEric S. Raymond <esr@snark.thyrsus.com>
Mon, 22 Mar 1993 16:53:22 +0000 (16:53 +0000)
20 files changed:
lisp/env.el
lisp/help.el
lisp/mail/rfc822.el
lisp/mail/sendmail.el
lisp/play/spook.el
lisp/play/studly.el
lisp/progmodes/simula.el
lisp/register.el
lisp/replace.el
lisp/reposition.el
lisp/rlogin.el
lisp/rot13.el
lisp/scroll-bar.el
lisp/simple.el
lisp/sort.el
lisp/tabify.el
lisp/textmodes/scribe.el
lisp/textmodes/sgml-mode.el
lisp/textmodes/spell.el
lisp/textmodes/text-mode.el

index 721c835a187e36489d8bc65dd1e080f259bb700d..3445d1c060e078af0ec04b3d52cfc84b416e3518 100644 (file)
@@ -3,7 +3,7 @@
 ;;; Copyright Free Software Foundation 1991
 
 ;; Maintainer: FSF
-;; Keywords: extensions
+;; Keywords: processes, unix
 
 ;;; This file is part of GNU Emacs.
 
 ;;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; UNIX processes inherit a list of name-to-string associations from
+;; their parents called their `environment'; these are commonly used
+;; to control program options.  This package permits you to set
+;; environment variables to be passed to any sub-process run under Emacs.
+
 ;;; Code:
 
 ;;;###autoload
index 68b3f6415931ef806060ec2f243dc3be0cbcf551..5cf31dfeb7809b50a44793fe526b847709c0c9e9 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This code implements GNU Emac's on-line help system, the one invoked by
+;;`M-x help-for-help'.
+
 ;;; Code:
 
 ;; Get the macro make-help-screen when this is compiled,
index f23f3029a170df7a515d77be0bef6b47f96b2631..373b0a85a2cb9be790209fdc40a7e7f07c98b1b2 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; Support functions for parsing RFC-822 headers, used by mail and news
+;; modes.  
+
 ;;; Code:
 
 ;; uses address-start free, throws to address
index f0de0525ce50fe42beff8089640c4b639fdb19ca..0d2cb929f81a2c02556cea66f44a174925c3993d 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This mode provides mail-sending facilities from within Emacs.  It is
+;; documented in the Emacs user's manual.
+
 ;;; Code:
 
 ;;;###autoload
index d1b31b757a1ea39915bf76a6f60638699a8458ea..1ba0b2dabb6b9d5d145dc3c2bd85d0342c5ba621 100644 (file)
@@ -4,6 +4,7 @@
 
 ;; Maintainer: FSF
 ;; Keywords: games
+;; Created: May 1987
 
 ;; This file is part of GNU Emacs.
 
@@ -26,8 +27,7 @@
 ; Steve Strassmann (straz@media-lab.media.mit.edu) didn't write
 ; this, and even if he did, he really didn't mean for you to use it
 ; in an anarchistic way.
-; May 1987
-
+;
 ; To use this:
 ;  Make sure you have the variable SPOOK-PHRASES-FILE pointing to 
 ;  a valid phrase file. Phrase files are in the same format as
@@ -38,7 +38,7 @@
 ;  Just before sending mail, do M-x spook.
 ;  A number of phrases will be inserted into your buffer, to help
 ;  give your message that extra bit of attractiveness for automated
-;  keyword scanners.
+;  keyword scanners.  Help defeat the NSA trunk trawler!
 
 ;;; Code:
 
index 1f215003c962877210ebed00d56cdf8442838629..b5aafcab09a9f9c1fe248ca2b0b26c7fbf0813f2 100644 (file)
@@ -5,6 +5,12 @@
 
 ;; Keywords: games
 
+;;; Commentary:
+
+;; Functions to studlycapsify a region, word, or buffer.  Possibly the
+;; esoteric significance of studlycapsification escapes you; that is,
+;; you suffer from autostudlycapsifibogotification.  Too bad.
+
 ;;; Code:
 
 (defun studlify-region (begin end)
index e6757432ac384da0434e72bb6159ae0229758e1b..6c3a41735a82733086c20f9e16aab48b7b88f97b 100644 (file)
 
 ;;; Commentary:
 
-;; Hans Henrik Eriksen may be reached at:
+;; A major mode for editing the Simula language.  It knows about Simula
+;; syntax and standard indentation commands.  It also provides convenient
+;; abbrevs for Simula keywords.
+;;
+;; Hans Henrik Eriksen (the author) may be reached at:
 ;;         Institutt for informatikk,
 ;;         Universitetet i Oslo
 
index 447c4c4a595a2bb64f1b212ee5436dc435af5b7b..24487dac7b1ec55ce1bdcf5221cb52df7cb6f1f8 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This package of functions emulates and somewhat extends the venerable
+;; TECO's `register' feature, which permits you to save various useful
+;; pieces of buffer state to named variables.  The entry points are
+;; documented in the Emacs user's manual.
+
 ;;; Code:
 
 (defvar register-alist nil
index 3c195224ad93654c51771e70e4c83410d3a67cb5..449d5243ee373bf76b853d66939ced33135c820d 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This package supplies the string and regular-expression replace functions
+;; documented in the Emacs user's manual.
+
 ;;; Code:
 
 (defconst case-replace t "\
index 9839c9afb69f3d5b6efae0bf2e35ae08a233d554..d981eefec5e9d10778090dad2e24d93dae103d39 100644 (file)
@@ -3,6 +3,7 @@
 ;; Copyright (C) 1991 Free Software Foundation, Inc.
 
 ;; Author: Michael D. Ernst <mernst@theory.lcs.mit.edu>
+;; Created: Jan 1991
 ;; Maintainer: FSF
 
 ;; This file is part of GNU Emacs.
@@ -23,8 +24,6 @@
 
 ;;; Commentary:
 
-;;; Written by Michael D. Ernst, mernst@theory.lcs.mit.edu, Jan 1991.
-
 ;;; Reposition-window makes an entire function definition or comment visible,
 ;;; or, if it is already visible, places it at the top of the window;
 ;;; additional invocations toggle the visibility of comments preceding the
index db0832c2d5bc6a8e93960ff555eb6e1492a4283b..bd6fc6ec3f6e6e16a23bee027e042dfc862edc87 100644 (file)
@@ -3,28 +3,32 @@
 ;; Maintainer: Noah Friedman <friedman@prep.ai.mit.edu>
 ;; Keywords: unix, comm
 
-;;; Copyright (C) 1992 Free Software Foundation, Inc.
-;;;
-;;; This program is free software; you can redistribute it and/or modify
-;;; it under the terms of the GNU General Public License as published by
-;;; the Free Software Foundation; either version 2, or (at your option)
-;;; any later version.
-;;;
-;;; This program is distributed in the hope that it will be useful,
-;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;;; GNU General Public License for more details.
-;;;
-;;; You should have received a copy of the GNU General Public License
-;;; along with this program; if not, you can either send email to this
-;;; program's author (see below) or write to:
-;;;
-;;;              The Free Software Foundation, Inc.
-;;;              675 Massachusetts Avenue.
-;;;              Cambridge, MA 02139, USA. 
-;;;
-
-;;; Todo: add directory tracking using ange-ftp style patchnames for the cwd.
+;; Copyright (C) 1992 Free Software Foundation, Inc.
+;;
+;; This program is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+;;
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+;;
+;; You should have received a copy of the GNU General Public License
+;; along with this program; if not, you can either send email to this
+;; program's author (see below) or write to:
+;;
+;;              The Free Software Foundation, Inc.
+;;              675 Massachusetts Avenue.
+;;              Cambridge, MA 02139, USA. 
+;;
+
+;;; Commentary:
+
+;; Support for remote login over Internet using rlogin(1).
+;;
+;; Todo: add directory tracking using ange-ftp style patchnames for the cwd.
 
 ;;; Code:
 
index 30c1b3d41a48cf59e6a8c179ae661108d19d392e..75af4d1026deed934284a945f22c5fd0223310b0 100644 (file)
 
 ;; Commentary:
 
+;; The single entry point, `rot13-other-window', oerforms a Caesar cipher
+;; encrypt/decrypt on the current buffer and displays the result in another 
+;; window.  Rot13 encryption is sometimes used on USENET as a read-at-yur-
+;; own-risk wrapper for material some might consider offensive, such as
+;; ethnic humor.
+;;
 ;; Written by Howard Gayle.  See case-table.el for details.
-
 ;; This hack is mainly to show off the char table stuff.
 
 ;;; Code:
index a924295faaa6f3aad8c7b79ccbb78a9b9200ee61..2aaf0d8e163ee1d44fedf2250c42ef1871e56b3e 100644 (file)
 
 ;;; Code:
 
+;;; Commentary:
+
+;; Window-system-independent bindings of mouse clicks on the scroll bar.
+;; Presently emulates the scroll-bar behavior of xterm.
+;;; Code:
+
 (require 'mouse)
 
 \f
index 6577fb92d143ff0de828b04aa5420385b80281e7..6d27c2122ef8bbd6c78b0b9131cbaea4ac3b81fb 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; A grab-bag of basic Emacs commands not specifically related to some
+;; major mode or to file-handling.
+
 ;;; Code:
 
 (defun open-line (arg)
index 8c3285e144a03536a315a590f1d1de78977bd0ed..0ee90121ae080f21482a32fbd54af25d51b5db67 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;;; This package provides the sorting facilities documented in the Emacs
+;;; user's manual.
+
 ;;; Code:
 
 (defun sort-subr (reverse nextrecfun endrecfun &optional startkeyfun endkeyfun)
index b1a8e35fe2eefe8a75870b0ba6f378fb837d5fa6..cccc99ea1a58ce9e6ddc90d8e398508051560167 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; Commands to optimize spaces to tabs or expand tabs to spaces in a region
+;; (`tabify' and `untabify').  The variable tab-width does the obvious.
+
 ;;; Code:
 
 ;;;###autoload
index 6954f5c62841ac5486108ebd063855d52bc9178b..d664292c3d115304c0f140abc3e07735ea6c4991 100644 (file)
 ;; It should be in a file named COPYING.  Among other things, the
 ;; copyright notice and this notice must be preserved on all copies.
 
+;;; Commentary:
+
+;; A major mode for editing source in written for the Scribe text formatter.
+;; Knows about Scribe syntax and standard layout rules.  The command to
+;; run Scribe on a buffer is bogus; someone interested should fix it.
+
 ;;; Code:
 
 (defvar scribe-mode-syntax-table nil
index b6200ac0bc746950c09ab5463affb1b22c1de5a9..676edaf051932a323ff7a96cbe30743fe51b66ac 100644 (file)
@@ -24,6 +24,8 @@
 
 ;;; Commentary:
 
+;; Major mode for editing the SGML document-markup language.
+;;
 ;; Some suggestions for your .emacs file:
 ;;
 ;; (autoload 'sgml-mode "sgml-mode" "SGML mode" t)
index 6e05a8c0fad3de8531e9c6e70ad15566660a32ad..e1ed847ca79795bf60e9acc9cd10f8adc925dc6e 100644 (file)
@@ -3,7 +3,7 @@
 ;; Copyright (C) 1985 Free Software Foundation, Inc.
 
 ;; Maintainer: FSF
-;; Keywords: wp
+;; Keywords: wp, unix
 
 ;; This file is part of GNU Emacs.
 
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This mode orovides an Emacs interface to the UNIX spell(1) program.
+;; Entry points are `spell-buffer', `spell-word', `spell-region' and
+;; `spell-string'.  These facilities are documented in the Emacs user's
+;; manual.
+
 ;;; Code:
 
 (defvar spell-command "spell"
index 0f9229e80a3f3a2339e5d6d0892cab650c627a61..b4b543f9a47ed301ebeeff8204bad9ad317441bc 100644 (file)
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+
+;;; Commentary:
+
+;; This package provides the fundamental text mode documented in the
+;; Emacs user's manual.
+
 ;;; Code:
 
 (defvar text-mode-syntax-table nil